home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d21 / dvex0320.arc / DVEXEC.DOC < prev    next >
Text File  |  1989-03-22  |  5KB  |  121 lines
  1. DVEXEC.COM - Version 20-March-1989
  2. Copyright (C) 1989 George A. Stanislav
  3. All rights reserved
  4.  
  5. DVEXEC allows you load and run programs in another window from a batch file.
  6. This is of great advantage especially to sysops of electronic bulletin board
  7. systems who often need to run a program at a certain specific time unattended.
  8. Under usual circumstances they use a batch file which runs the program while
  9. their BBS is waiting idle.
  10.  
  11. With DVEXEC you can run such programs in another DESQview window and return
  12. to BBS program while doing that. Of course, DVEXEC is not limited to operators
  13. of BBS.
  14.  
  15. How does it work? Simply type DVEXEC followed by the name of the PIF control-
  16. ling the program you want to run. Typically, your PIF will be in the C:\DV
  17. directory. Its name will usually be two characters, followed by a dash, 'PIF',
  18. dot and the 'DVP' extension.
  19.  
  20. For example, the DOS Services program will most likely be defined in
  21. C:\DV\DS-PIF.DVP. To run it from a batch file, place the following line in
  22. the batch file:
  23.  
  24.                 DVEXEC C:\DV\DS-PIF.DVP
  25.  
  26. Please note that the command is case insensitive. You can use any combination
  27. of lower and upper case.
  28.  
  29. When DVEXEC runs, it first shrinks its own memory to mere two kilobytes so as
  30. not to take up too much of the system resourses.
  31.  
  32. Then it will check if DESQview is loaded. If not, it will post a message on
  33. your screen and exit with errorlevel 1.
  34.  
  35. If it finds DESQview, it will open the PIF, read it and tell DESQview to open
  36. a window defined in the PIF.
  37.  
  38. There are several possible problems DVEXEC can encounter, besides DESQview
  39. not being loaded as mentioned above. The PIF may not be on the system or it
  40. may be impossible to open or read the PIF. Last but not least, DESQview may
  41. not be able to open another window, typically because non-swappable windows
  42. are in the way.
  43.  
  44. In all the above cases, DVEXEC will post a message on the screen and will exit
  45. with an errorlevel. The messages can be redirected to a file for later
  46. examination, for example like this:
  47.  
  48.                 DVEXEC C:\DV\D1-PIF.DVP >> C:\DV\DVEXEC.LOG
  49.  
  50. Note that you need a double >>, or else each time you run the program the
  51. log will be overwritten.
  52.  
  53. If DVEXEC and DESQview are successful, DVEXEC will inform you and will print
  54. the task handle on the screen. This message, of course, can be redirected as
  55. all others. DVEXEC will then exit with errorlevel 0.
  56.  
  57. Here is a list of errorlevels which can be acted upon by your batch file:
  58.  
  59.         - Success:                      0
  60.         - DESQview not loaded:          1
  61.         - No PIF specified:             1
  62.         - PIF not found:                1
  63.         - Can't open PIF:               1
  64.         - Can't read PIF:               1
  65.         - DESQview cannot run PIF:      2
  66.  
  67. Simplified: Success = 0, non-DESQview related problem = 1, DESQview
  68. related problem = 2.
  69.  
  70. Please note that batch files look for errorlevel equal to OR greater than
  71. requested. Thus your batch file should check for errorlevel 2 first, 1 second,
  72. then default to 0 (success).
  73.  
  74. One final note: Once DVEXEC loads a program, it has no more control over it.
  75. It will not be able to close the window it has opened. For that reason, you
  76. should either use it with programs you have configured to close their window
  77. when done, or programs running from a batch file ending with the EXIT line,
  78. or finally programs you do not want to close.
  79.  
  80.                           New in this version
  81.  
  82. If you PRECEDE the file name with a forward slash '/', DVEXEC will first
  83. load the file as before, then it will ask DESQview to hide the process.
  84. DESQview may or may not grant this request depending on the program itself
  85. (programs may force themselves to be the top applications although most
  86. do not).
  87.  
  88. Example:
  89.  
  90.         dvexec / c:\dv\ds-pif.dvp
  91.  
  92. This will load DOS Services and hide them. The hidden process continues to
  93. work in the background IF you have configured it to. The hidden process cannot
  94. be made visible by double tapping on the DESQ key. However, it can be made
  95. visible by using standard DESQview menu to switch windows (DESQ-S).
  96.  
  97. LICENSE: This program may be freely distributed as long as there is no charge
  98. connected with the distribution. Companies that sell public domain and
  99. shareware programs are expressly prohibited from distributing this program.
  100. This program is NOT in public domain, the author retains all the rights to
  101. this program, including the right to have the program taken out of public
  102. distribution.
  103.  
  104. LICENSE FEE: The cost of software development tools is high. I am sorry but
  105. I can no longer give out all my programs for free as I have been doing for
  106. several years now.
  107.  
  108. If you use this program, please send $20 (US currency) to:
  109.  
  110.         George A. Stanislav
  111.         P.O. Box 129
  112.         Natrona Heights, PA 15065
  113.         U.S.A.
  114.  
  115. NO FURTHER VERSIONS OF DVEXEC WILL BE POSTED ON BULLETIN BOARDS. If I continue
  116. working on this program, I will let registered users know how to receive a
  117. newer version.
  118.  
  119.  
  120.  
  121.